{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Tutorial 2d - Raytracing Aspheres"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "tags": [
     "nbsphinx-toctree"
    ]
   },
   "source": [
    "### July 2024"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This tutorial shows how even aspheres can be modeled in Optiland. We will first assess a simple spherical lens, then compare it to an even asphere."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [],
   "source": [
    "import numpy as np\n",
    "\n",
    "from optiland import analysis, optic"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "1. Spherical Singlet"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Let's define a simple singlet:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 1000x400 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "spherical = optic.Optic()\n",
    "\n",
    "# add surfaces\n",
    "spherical.add_surface(index=0, radius=np.inf, thickness=np.inf)\n",
    "spherical.add_surface(\n",
    "    index=1,\n",
    "    thickness=7,\n",
    "    radius=20.0,\n",
    "    is_stop=True,\n",
    "    material=\"N-SF11\",\n",
    ")\n",
    "spherical.add_surface(index=2, thickness=21.56201105)\n",
    "spherical.add_surface(index=3)\n",
    "\n",
    "# add aperture\n",
    "spherical.set_aperture(aperture_type=\"EPD\", value=20.0)\n",
    "\n",
    "# add field\n",
    "spherical.set_field_type(field_type=\"angle\")\n",
    "spherical.add_field(y=0)\n",
    "\n",
    "# add wavelength\n",
    "spherical.add_wavelength(value=0.587, is_primary=True)\n",
    "\n",
    "spherical.update_paraxial()\n",
    "\n",
    "spherical.draw(num_rays=10)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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4IEHRC5excuffPJJcXMQExNDaWlp9NFHH9G5c+dozJgxYlmvXr1o586dTmm45pprxLIjR45odHQAwIgQpMFUOEBzwB0/fjxNnjyZZs+eLV435j//+Q/179+/3nIOyAsWLBCBnuuNN23aRNddd52Yj5gfK1asoFdffZXef/99p/VefPFF+vWvf0179uyh0aNHi7Rw0L799ttp9+7d1LlzZ/HasRCrQ4cOlJKSItICAKAKtf8PwASCgoLolVdeoW7dulHPnj1p5syZTa6TmZnpNkhXV1eLbXFQZZyT5sCck5MjcsTdu3enYcOG0Zdffknjxo2zrzdq1Ci65557xP/5JoG3cdlll9GNN94olj3yyCM0aNAgsR1urKZq27atSAsAgAo5aTCdpUuXiuJprmM+depUk58vLy+niIiIest5G2qAZpzT5eJsDtCOy86ePeu0HhdnO77P+IbBdZnrepGRkSL3DgCgQpAGU9m8ebMobua65AEDBtBdd93lVKzsTlJSEuXn59dbzi2uXXPp7pa5dp1y/Ay/39Ay1/Xy8vIoOTnZg70EAKtAkAbT4FzoHXfcQVOmTBHF0K+//jpt376dFi9e3Oh6ffv2pf3795OeKioqRKMxTgsAgApBGkyD+zpzrplbeDMump4/fz49/PDDdPz48QbXGzFiBG3ZssWplXagbd26lWw2m6irBgBQIUiDKXz11Veir/Ebb7wh6pJV3ICLBzlprNj76quvptDQUPr8889JL2+//bbo2+2YdgAADGYC8MtgItyfef369QH/27m5uaIvNveT7tSpU8D/PgDIC12wAH7JcRcUFIixuwM9NCgXxf/9739HgAaAepCTBgAAkBTqpAEAACSFIA0AACApBGkAAABJIUgDAABICkEaAABAUgjSAAAAkkKQBgAAkBSCNAAAgKQQpAEAAEhO/w8rIhtOfOh2uwAAAABJRU5ErkJggg==",
      "text/plain": [
       "<Figure size 1200x400 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "spot = analysis.SpotDiagram(spherical)\n",
    "spot.view()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "As we can see, this lens shows a significant amount of spherical aberration, as is typical for such a lens."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "2. Aspherical Singlet"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Let's now define an asphere which has improved spherical aberration performance.\n",
    "\n",
    "We define the \"surface_type\" attribute as \"even_asphere\" and we supply a list of coefficients of the aspheric terms. The aspheric surface sag equation is\n",
    "\n",
    "$z(r) = \\frac{r^2}{R(1 + \\sqrt{1 - (1 + \\kappa)\\frac{r^2}{R^2}})} + \\alpha_2r^2 + \\alpha_4r^4 + \\alpha_6r^6 + \\ldots$\n",
    "\n",
    "where $z$ is the sag, $R$ is the radius of curvature, $r$ is the radial distance from the optical axis, and $\\alpha_2, \\alpha_4, \\alpha_6, \\ldots$ are the coefficients of the asphere. The coefficient list provided to the surface is simply $[\\alpha_2, \\alpha_4, \\alpha_6, \\ldots]$."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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yy4b8O9PRESnxnBERER2pWvAOFGbPHnyKe//+OOPo7i4GD4+Phho48ePl9/7qquuGvDvTUREp+fWg9sQERHZDGvAONZnn32G2267DX/4wx9OeX+dToeQkBAoQaPRyO/t4eGB5uZmRfpAREQnx5kjIiKyK9aA0bVVVVXhvvvuw0MPPYQ5c+b06uu9/fbb8PX1xRdffIGkpCR4enriyiuvRENDA9555x25FM/Pzw933XUX2tvbO+8nrv/b3/6G66+/Ht7e3oiOjpYBrby8HJdeeqm8Lj09HZs2beqH3wIREfUHhiMiIrJrYu+QCCOTJk3CE088cUZfQwShl156CUuXLsU333wjl+7Nnj0bX331lWz/+9//8Prrr+PDDz/sdr8XXngB55xzDrZs2YKZM2fiuuuuk2Hp2muvxebNmxEfHy8/NpvNffTTEhFRf+KyOiIislsmkwnz5s2Dm5sb3n//fbnn6Ey0trbi1VdflWFGEDNHIhCVlpbKGaDU1FS5l+mHH37A1Vdf3Xm/GTNm4NZbb5X//9e//lV+jVGjRnXOXt1///0YN26c/DpKLeUjIqKeYzgiIiK7JZbRrV+/Hhs3bpR7ic6UWEpnDUZCcHCwXDYnglHX68rKyrrdTyyb6/p5IS0t7bjrxP0YjoiIbB/DERER2SWxBO65557Dl19+icTExLP6Wmq1utvHYgbqRNeJmaqT3c86a3Wi6469HxER2SbuOSIiIruzdetW3HTTTXjqqacwbdo0pbtDREQOgjNHRERkVyoqKuQBqqIAgyh8UFJS0u3zrq6uMBgMivWPiIjsF8MRERHZFbGMLjc3V7bQ0NDjPi9Kah8+fFiRvhERkX1zMbO+KBEROQlRZOHuu++WTUnz58+XJcg/+eQTRftBRETdcc8RERE5FVFeW1Shq6mpGfDv/dNPP8nvLcqOExGR7eHMEREROQ2xFE+caSTExcVBpRrY9wgbGxtRWFgo/1+EJJb3JiKyLQxHREREREREXFZHRERERERkwXBERERERETEcERERERERGTBcERERERERMRwREREREREZMFwRERERERExHBERERERERkwXBERERERETEcERERERERATp/wHVmRIW0V0PeAAAAABJRU5ErkJggg==",
      "text/plain": [
       "<Figure size 1000x400 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "asphere = optic.Optic()\n",
    "\n",
    "# add surfaces\n",
    "asphere.add_surface(index=0, radius=np.inf, thickness=np.inf)\n",
    "asphere.add_surface(\n",
    "    index=1,\n",
    "    thickness=7,\n",
    "    radius=20.0,\n",
    "    is_stop=True,\n",
    "    material=\"N-SF11\",\n",
    "    surface_type=\"even_asphere\",\n",
    "    conic=0.0,\n",
    "    coefficients=[\n",
    "        -2.248851e-4,\n",
    "        -4.690412e-6,\n",
    "        -6.404376e-8,\n",
    "    ],  # <-- coefficients for asphere\n",
    ")\n",
    "asphere.add_surface(index=2, thickness=21.56201105)\n",
    "asphere.add_surface(index=3)\n",
    "\n",
    "# add aperture\n",
    "asphere.set_aperture(aperture_type=\"EPD\", value=20.0)\n",
    "\n",
    "# add field\n",
    "asphere.set_field_type(field_type=\"angle\")\n",
    "asphere.add_field(y=0)\n",
    "\n",
    "# add wavelength\n",
    "asphere.add_wavelength(value=0.587, is_primary=True)\n",
    "\n",
    "asphere.update_paraxial()\n",
    "\n",
    "asphere.draw(num_rays=5)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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68PmzZut66OIFwHIdp2cnBzV9qC6/aozZ+xHe3DTiDpvdMEj8hqubjFHzoUuNT179jR2795tfPfdd0b79u3LdRVLTEw0OnbsqN637SoWFxdnbN26VXUVS0hIUA+Lzz77zHjzzTdV951ff/3VeO2114yQkBBj3rx5hid1cUJL8HfeeUe12p82bZrq4pScnKzenzBhgjF79uxyXZz8/PyM559/XrXOnz9/vt2uYviMTz/91Pjpp59Ui2lv6CrmyP2Ym5tr/PWvf1U9H06dOmV89dVXxjXXXKOO68LCQpf9nUT1jcHbw128eFEF69DQUCMsLMyYPHmyugBa4AKIe7ht27ZZlyGY3H///UZkZKQKyiNGjFB9aW27m/Xo0UN9ZoMGDVQ/8mXLlqluQJ7klVdeUTcx6KeMLk/oK28xYMAA1WXJ1gcffGB06NBBrd+1a1fj888/L/c+uos9+eSTRkxMjApogwYNMo4fP254Okfux4KCAuPmm282GjdurIJ6fHy86jtuuRkg8hacEpSIiEgzrPMmIiLSDIM3ERGRZhi8iYiINMPgTUREpBkGbyIiIs0weBMREWmGwZuIiEgzDN5ERESaYfAmugyM7Y5xyXNzc+v9uzdt2iQ9evRQY4ITEVkweJPHw5zS/fv3V3NA28rOzpbY2Fh54oknqt1+zpw58sADD0jDhg2lvmHuakwUs3Llynr/biJyXxwelbzCL7/8onKwb775powfP14tmzhxovz444+yd+9eNQOWPZhNrV27dnLq1Clp0aKFuMLSpUvlnXfeUekkIgLmvMkrdOjQQZ599lmVg75w4YJ8+umnsnr1almxYkWVgRs++OAD6d69e7nAjUAaEREhGzZskI4dO0pISIiMHj1aCgoK5N///re0atVKTY/64IMPqly/BZY//fTT6qYhNDRU4uPj5bPPPpO0tDQZPny4Wnb11VfLvn37yqXhT3/6k1p24sQJJ+0dItINgzd5DQRuBOIJEybItGnTZN68eep1db799lvp3bt3peUI1C+//LK6AUC99Ndffy0jRoyQjRs3qse7774rb7zxhqxbt67cdkuWLJHrrrtODh48KMOGDVNpQTC/88475cCBA9K2bVv12rZALC4uTmJiYlRaiIjAj7uBvIWPj4+8/vrr0rlzZ+nWrZvMnj37stucOXPGbvAuKSlRn4VgC8h5I2CnpKSoHHSXLl1k4MCBsm3bNhkzZox1u1tvvVXuuece9W/cPOAzrr32Wrn99tvVsscee0wSEhLU56CRnEXz5s1VWoiIgDlv8ipvvfWWKuZGHXZiYuJl17906ZIEBQVVWo7PsARuQM4YxeII3LbLUlNTy22HYnHb9wE3EhWXVdwuODhY5faJiIDBm7zGjh07VLE16qr79OkjU6ZMKVc8bU90dLRkZmZWWo4W4BVz9faWVeziZbsO3q9qWcXtMjIypHHjxjX4K4nIGzB4k1dArvWuu+6S++67TxVn/+tf/5I9e/bIsmXLqt2uZ8+ecuTIEXGlwsJC1VgNaSEiAgZv8groq41cNlqcA4q4n3/+efnb3/4mp0+frnK7IUOGyM6dO8u1Gq9vu3btksDAQFUXTkQEDN7k8bZv3676Sr/99tuqrtoCDccweEt1xee33HKL+Pn5yVdffSWu8v7776u+6bZpJyLvxkFaiC4DgR/9sb/44ot6/+709HTVlxz9vFu3bl3v309E7oldxYguAzn0rKwsNbZ5fQ+RiiL91157jYGbiMphzpuIiEgzrPMmIiLSDIM3ERGRZhi8iYiINMPgTUREpBkGbyIiIs0weBMREWmGwZuIiEgzDN5ERESaYfAmIiISvfx/yAhmhH/7Oc4AAAAASUVORK5CYII=",
      "text/plain": [
       "<Figure size 1200x400 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "spot = analysis.SpotDiagram(asphere)\n",
    "spot.view()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We can see that the rays now focus much closer to the optical axis and that the spot size has reduced significantly."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Conclusions:\n",
    "\n",
    "- This tutorial introduced the even asphere surface type.\n",
    "- To use an aspheric surface, we simply specify surface_type='even_asphere' and provide the list of aspheric coefficients."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This tutorial used an asphere that had alredy been optimized for minimal wavefront error. We ignored these details here, but future tutorials will elaborate on the asphere optimization process."
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": ".venv",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.13.2"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}
